home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / olrdrs / bws_12.zip / BWSAVE.DOC next >
Text File  |  1993-03-03  |  7KB  |  146 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                    BWSave
  7.  
  8.  
  9.  
  10.                        A simple Blue Wave packet merger.
  11.  
  12.                  Version 1.2                February, 1993 
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.         (c) Copyright  David A. Gersic 1993.  All rights reserved 
  27.  
  28.  
  29.                 Quick Start: For people who hate reading entire 
  30.         documentation files just to find out what a program does, 
  31.         this compressed file contains a program that will merge
  32.         Blue Wave mail packets so that you can keep important  
  33.         messages in a format where they are easily used and found.
  34.         It is command line driven and has no options other than the
  35.         name of the mail packets to work with.
  36.                  
  37.                 Installation: Installation of BWsave is simple, just 
  38.         decompress the executable file (BWSAVE.EXE) into a 
  39.         subdirectory that is on your DOS path. 
  40.  
  41.                 Operation: BWSave takes two command line arguments,
  42.         the name of the packet to scan for saved messages, and the name
  43.         of the packet to copy them to. Messages that are marked for 'Save'
  44.         in the mail packet will be copied to the save packet. For example, 
  45.         the mail I download from my own bbs has a name like CONNECTN.SA1 
  46.         (see the Blue Wave documentation for an explanation of valid Blue 
  47.         Wave mail packet names), and I use CONNECTN.999 as my permanent 
  48.         message archive. The command line 'BWSAVE CONNECTN.SA1 
  49.         CONNECTN.999' will uncompress CONNECTN.SA1 and CONNECTN.999 to 
  50.         temporary directories, add messages marked for saving in 
  51.         CONNECTN.SA1 to the packet in CONNECTN.999 and recompress 
  52.         CONNECTN.999. Warning: you should specify a valid Blue Wave 
  53.         packet file name for the save packet name. BWSave doesn't care
  54.         what you name it, but Blue Wave will only "see" correct file names.
  55.         
  56.                 Speed: From my own testing, most of BWSave's processing
  57.         time is spent shelling to the archiving programs. A good disk 
  58.         cache does speed up BWSave's operation, though, as it is   
  59.         disk intensive. I use, and recommend, HyperDisk, but others 
  60.         like SmartDrive, NCache, or PC-Kwik should work.
  61.  
  62.                 Bugs: As far as I know, there are no actuall bugs in 
  63.         BWSave, but there are a few potential bits of wierdness. First,
  64.         BWSave makes no attempt to keep you from saving the same message
  65.         twice. Second, the sorting algorthm I used is not 'stable'
  66.         (meaning that duplicate records are not garaunteed to come out
  67.         in the same order that they started), so messages _within_ an 
  68.         area may be out of (posting) order. If I get around to writing 
  69.         a new sort function that is stable, this anomally will go away.
  70.         Third, I detect the type of archiver used to compress the mail
  71.         packet, but only Zip, LHA, ARJ, and Pak format archives can be
  72.         handled. Any other archiver will give you an error message. If 
  73.         somebody wants to NetMail me the command lines that should be 
  74.         used for Zoo, ARC, and ARC6 formats, I'll be happy to add them.
  75.         Archiver detection may not be perfect, either, as I only use
  76.         and tested Zip, LHA, and ARJ. Fourth, BWSave assumes that it can
  77.         find your archive utilities on your DOS PATH, and that they are 
  78.         named PKZIP/PKUNZIP, LHA, or ARJ. If you have renamed them, BWSave
  79.         will not be able to find them and may work in strange and 
  80.         wonderous ways.                
  81.  
  82.                 Legal Caveats: While I have tried my hardest to develop 
  83.         and test this software to ensure that there are no bugs in 
  84.         it, I make no claim that it is perfect. If any bugs are 
  85.         found, I would appreciate a report of them, but I take no 
  86.         responsibility for any damage they may do. 
  87.  
  88.         This software is copyrighted material. It may be 
  89.         distributed freely, but only in complete and unmodified 
  90.         form. If you are going to use it regularly, you must 
  91.         register it. As this is a simple utility that I wrote because
  92.         I wanted one, I'm only asking for $5. If it isn't worth $5
  93.         to you, delete it from your disk. Remember, shareware only 
  94.         works if you pay.
  95.  
  96.         Thanks go to: 
  97.              George Hatchew, author of the Blue Wave mail system.
  98.                 The packet structures used in BWSave were obtained 
  99.                 from him to ensure (I hope) compatibility.
  100.              Fabrice Bellard, author of Lzexe.
  101.              Bob Stout, keeper of the C_Echo SNIPPETs.
  102.              Heinz Ozwirk, for a modified version of his archiver 
  103.                 detection code.
  104.              Walter Bright, for the file_copy() function.
  105.              Michael Tatum and George Worley for pointing out a few
  106.                 bugs that I missed in version 1.0.   
  107.              George Worley for pointing out a bug in 1.1, also.
  108.  
  109.         New in version 1.1:
  110.              Deleting all of the messages in a message area was 
  111.                 confusing BWSave which would then run out of 
  112.                 memory trying to add a new message to the saved
  113.                 packet; fixed.
  114.              Only about 120 messages could be saved; fixed. I tested 
  115.                 saving up to over 1600 messages and had no problems
  116.                 with BWSave or Blue Wave handling the packet.
  117.         New in version 1.2:
  118.              BWSave was producing a <BBS Name>.MIX file that the Blue
  119.                 Wave reader couldn't work with. It appeared that BWSave
  120.                 was not saving some messages marked for saving, but in
  121.                 fact the messages were in the save packet; you just 
  122.                 couldn't see them with the Blue Wave reader. As far as
  123.                 I can tell, using the 1.2 version of BWSave will 
  124.                 'correct' the broken save packet and all saved messages
  125.                 will show up automagically.
  126.  
  127.         For Those Who Are Interested: This software was written in 
  128.         the C language, using Microsoft's C compiler ver. 6.00, and 
  129.         compressed with Fabrice Bellard's Lzexe file compressor.
  130.  
  131.         Contacting the Author: 
  132.          
  133.         U.S. Mail:      David Gersic
  134.                         927 E. Garden St.
  135.                         DeKalb, Il 60115
  136.                         (815) 753-8548
  137.  
  138.         BITNET:         A02DAG1@NIU.BITNET
  139.  
  140.         Internet:       a02dag1@noc.niu.edu
  141.  
  142.         FidoNet:        1:11/70.
  143.  
  144.  
  145. BWSave      (c) Copyright  David A. Gersic 1993.        All rights reserved 
  146.